New and Changed Printing Functions

Because the Carbon Printing Manager replaces all of the original Printing Manager functions you are using today, the first step in converting your code is to locate and replace your old Printing Manager function calls with their Carbon equivalents. In most cases there is a one-to-one mapping between the new functions and the original functions they replace. The following table lists the Carbon equivalents for original Printing Manager functions.

Carbon replacements for original Printing Manager functions

Original Function	Carbon Function
`PrOpen`	`PMBegin`
`PrClose`	`PMEnd`
`PrOpenDoc`	`PMBeginDocument`
`PrCloseDoc`	`PMEndDocument`
`PrOpenPage`	`PMBeginPage`
`PrClosePage`	`PMEndPage`
`PrintDefault`	`PMDefaultPrintSettings`
	`PMDefaultPageFormat`
`PrValidate`	`PMValidatePrintSettings`
	`PMValidatePageFormat`
`PrJobInit`	`PMPrintDialogInit`
`PrJobDialog`	`PMPrintDialog`
`PrStlInit`	`PMPageSetUpDialogInit`
`PrStlDialog`	`PMPageSetUpDialog`
`PrDlgMain`	Use `PMPrintDialogMain` for the Print dialog box.
	Use `PMPageSetUpDialogMain` for the Page Setup dialog box.
`PrGeneral`	`PMGeneral`
`PrSetError`	`PMSetError`
`PrError`	`PMError`
`MyDoPrintIdle`	`PMSetIdleProc`
`MyPrDialogAppend`	Use `MyPrintDialogAppend` for the Print dialog box.
	Use `MyPageSetUpDialogAppend` for the Page Setup dialog box.

Some of the functionality provided by original Printing Manager is no longer supported, and therefore the Carbon Printing Manager does not provide replacements for the following routines:

Original Printing Manager functions that are not supported in Carbon


PrPicFile


PrPurge


PrNoPurge


PrLoadDriver


PrDrvrDCE


PrDrvrOpen


PrDrvrClose


PrDrvrVers


PrCtlCall


PrJobMerge

The PrPicFile function was removed because the "deferred" printing style is no longer supported. All print records must use "draft" style, and printer drivers must perform their own spooling or use the Desktop Printer Spooler. Refer to the original Printing Manager documentation for information about draft and deferred printing styles. The Desktop Printer Spooler is described in Tech Note 1097.